Skip to content

Restyle the docs to the liquid.ai look - #167

Merged
ovenmitt merged 1 commit into
mainfrom
ovenmitt/mintlify-styling-explain
Nov 9, 2026
Merged

ovenmitt merged 1 commit into
mainfrom
ovenmitt/mintlify-styling-explain

Conversation

@ovenmitt

@ovenmitt ovenmitt commented Nov 8, 2026 •

Copy link
Copy Markdown
Collaborator

Refines the docs to match liquid.ai and makes mobile navigation and feedback clicks clearer. Page URLs, navigation destinations, and notebook links are preserved.

Changes

  • Article headers: 32px serif titles in black for light mode and white for dark mode, tighter spacing below the title and header, and smaller Copy page controls.
  • Navigation: collapsible sidebar sections, narrower right rails, and an always-visible native close button inside the mobile drawer’s sticky header.
  • Shared components: 2px corners, thinner card borders, flatter code blocks and callouts, neutral table headers and descriptive badges, and revised hover/focus styles. Step numbers and scrollbar handles stay round; availability ticks stay green.
  • Model pages: metadata above serif card titles, two-column category grids, format buttons that wrap on phones, and two previously missing capability icons fixed.
  • API reference: neutral method pills and Try it controls, violet path parameters, and narrower desktop examples to give the article more room.
  • Colab: all six original branded badges retained at 24px high, with their proportions and notebook links preserved.
  • Feedback: a two-second tick acknowledges Yes/No clicks while preserving Mintlify’s native voting behavior and labels.
  • Maintenance: shared styling guidance moves into DESIGN.md; CSS and its development copy remain synchronized.

Validation

  • Docs checks, the link-snapshot check (222 active URLs), and Mintlify deployment pass.
  • JavaScript syntax, CSS synchronization, and diff whitespace checks pass.
  • Desktop and phone views checked in light/dark mode, including menus, cards, tables, API controls, all Colab badges, and long 32px titles at 320px.
  • Mobile close controls and feedback interactions checked in Chromium and WebKit. Feedback tests block outgoing submissions; selection, keyboard activation, timeout, and navigation reset are verified.

@ovenmitt
ovenmitt requested review from a team and mlabonne as code owners November 8, 2026 02:02
@mintlify

mintlify Bot commented Nov 8, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
liquid-docs 🟢 Ready View Preview Nov 9, 2026, 4:05 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from 2de6c99 to bd7d78c Compare November 8, 2026 02:20
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from bd7d78c to 86da3ea Compare November 8, 2026 02:29
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from 86da3ea to bff99c3 Compare November 8, 2026 03:40
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from bff99c3 to ac98178 Compare November 8, 2026 03:50
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch 2 times, most recently from a543b25 to fe0c270 Compare November 8, 2026 19:16
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from fe0c270 to f08072a Compare November 8, 2026 19:20
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from f08072a to 7d9af6a Compare November 8, 2026 19:31
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from 7d9af6a to eada703 Compare November 8, 2026 20:18
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from eada703 to 9a97aa8 Compare November 8, 2026 20:44
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from 9a97aa8 to fd19739 Compare November 9, 2026 01:19
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from fd19739 to 9217fbc Compare November 9, 2026 01:34
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from 9217fbc to bf1b005 Compare November 9, 2026 02:48
Refine the shared liquid.ai theme with 32px serif page titles, pure black/white
article titles, tighter header spacing, quiet eyebrow and Copy page controls,
collapsible sidebar
sections, narrower TOC, flat cards/callouts/code/tables, neutral API controls,
and wider API articles. Keep the existing native mobile close behavior while
making its button visible inside the drawer header.

Reorder model-card metadata on category pages and wrap model format buttons.
Preserve all six original branded Colab badges and notebook links, with a
shared 24px image height. Fix the two unsupported capability icon names.

Briefly show a tick after native feedback clicks using documented button IDs;
leave voting and analytics to Mintlify. Reset the acknowledgement after two
seconds or navigation.

Move design guidance into DESIGN.md and document the shared styling and
navigation conventions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ovenmitt
ovenmitt force-pushed the ovenmitt/mintlify-styling-explain branch from bf1b005 to e465c42 Compare November 9, 2026 04:05
@ovenmitt
ovenmitt merged commit e480eab into main Nov 9, 2026
5 checks passed
@ovenmitt
ovenmitt deleted the ovenmitt/mintlify-styling-explain branch November 9, 2026 05:03

This branch was successfully deployed

1 active deployment
staging — e465c42f Deployed Nov 9, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant